pv

---

SynthDef Internals

FFT	A fast Fourier transform.
IFFT	An inverse fast Fourier transform.
PV_Add	Complex addition.
PV_BinScramble	Scrambles bins.
PV_BinShift	Shifts and stretches bin positions.
PV_BinWipe	Copies low bins from one input and the high bins of the other.
PV_BrickWall	Zeros bins.
PV_ChainUGen	Abstract base class for all phase-vocoder-chain unit generators.
PV_ConformalMap	Complex plane attack.
PV_Conj	Complex conjugate.
PV_Copy	Copies an FFT buffer.
PV_CopyPhase	Copies magnitudes and phases.
PV_Diffuser	Shifts phases randomly.
PV_Div	Complex division.
PV_HainsworthFoote	A FFT onset detector.
PV_JensenAndersen	A FFT feature detector for onset detection.
PV_LocalMax	Passes bins which are local maxima.
PV_MagAbove	Passes magnitudes above threshold.
PV_MagBelow	Passes magnitudes below threshold.
PV_MagClip	Clips magnitudes.
PV_MagDiv	Divides magnitudes.
PV_MagFreeze	Freezes magnitudes.
PV_MagMul	Multiplies FFT magnitudes.
PV_MagNoise	Multiplies magnitudes by noise.
PV_MagShift	Shifts and stretches magnitude bin position.
PV_MagSmear	Averages magnitudes across bins.
PV_MagSquared	Squares magnitudes.
PV_Max	Maximum magnitude.
PV_Min	Minimum magnitude.
PV_Mul	Complex multiplication.
PV_PhaseShift	Shifts phase.
PV_PhaseShift270	Shifts phase by 270 degrees.
PV_PhaseShift90	Shifts phase by 90 degrees.
PV_RandComb	Passes random bins.
PV_RandWipe	Crossfades in random bin order.
PV_RectComb	Makes gaps in the spectrum.
PV_RectComb2	Makes gaps in the spectrum.
RunningSum	Tracks running sum over n frames.

class supriya.ugens.pv.FFT(buffer_id=None, source=None, active=1, hop=0.5, window_size=0, window_type=0)

A fast Fourier transform.

>>> buffer_id = supriya.ugens.LocalBuf(2048)
>>> source = supriya.ugens.SoundIn.ar(bus=0)
>>> fft = supriya.ugens.FFT(
...     active=1,
...     buffer_id=buffer_id,
...     hop=0.5,
...     source=source,
...     window_size=0,
...     window_type=0,
... )
>>> fft
FFT.kr()

---

Attributes Summary

active	Gets active of FFT.
buffer_id	Gets buffer_id of FFT.
fft_size	Gets FFT size as UGen input.
hop	Gets hop of FFT.
new	Constructs a FFT unit generator graph.
source	Gets source of FFT.
window_size	Gets window_size of FFT.
window_type	Gets window_type of FFT.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(buffer_id=None, source=None, hop=0.5, window_type=0, active=1, window_size=0)

Constructs a FFT unit generator graph.

Returns unit generator graph.

---

Read-only properties

active

Gets active of FFT.

Returns input.

buffer_id

Gets buffer_id of FFT.

Returns input.

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

overridden fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

hop

Gets hop of FFT.

Returns input.

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

source

Gets source of FFT.

Returns input.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

window_size

Gets window_size of FFT.

Returns input.

window_type

Gets window_type of FFT.

Returns input.

class supriya.ugens.pv.IFFT(calculation_rate=None, pv_chain=None, window_type=0, window_size=0)

An inverse fast Fourier transform.

>>> pv_chain = supriya.ugens.LocalBuf(2048)
>>> ifft = supriya.ugens.IFFT.ar(pv_chain=pv_chain, window_size=0, window_type=0,)
>>> ifft
IFFT.ar()

---

Attributes Summary

ar	Constructs a audio-rate IFFT unit generator graph.
kr	Constructs a control-rate IFFT unit generator graph.
pv_chain	Gets pv_chain of IFFT.
window_size	Gets window_size of IFFT.
window_type	Gets window_type of IFFT.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod ar(pv_chain=None, window_type=0, window_size=0)

Constructs a audio-rate IFFT unit generator graph.

Returns unit generator graph.

classmethod kr(pv_chain=None, window_type=0, window_size=0)

Constructs a control-rate IFFT unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of IFFT.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

window_size

Gets window_size of IFFT.

Returns input.

window_type

Gets window_type of IFFT.

Returns input.

class supriya.ugens.pv.PV_Add(pv_chain_a=None, pv_chain_b=None)

Complex addition.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_add = supriya.ugens.PV_Add.new(pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,)
>>> pv_add
PV_Add.kr()

---

Attributes Summary

new	Constructs a PV_Add unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Add.
pv_chain_b	Gets pv_chain_b of PV_Add.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Add unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Add.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Add.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_BinScramble(pv_chain=None, wipe=0, width=0.2, trigger=0)

Scrambles bins.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_bin_scramble = supriya.ugens.PV_BinScramble.new(
...     pv_chain=pv_chain, trigger=0, width=0.2, wipe=0,
... )
>>> pv_bin_scramble
PV_BinScramble.kr()

---

Attributes Summary

new	Constructs a PV_BinScramble unit generator graph.
pv_chain	Gets pv_chain of PV_BinScramble.
trigger	Gets trigger of PV_BinScramble.
width	Gets width of PV_BinScramble.
wipe	Gets wipe of PV_BinScramble.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, wipe=0, width=0.2, trigger=0)

Constructs a PV_BinScramble unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_BinScramble.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

trigger

Gets trigger of PV_BinScramble.

Returns input.

width

Gets width of PV_BinScramble.

Returns input.

wipe

Gets wipe of PV_BinScramble.

Returns input.

class supriya.ugens.pv.PV_BinShift(pv_chain=None, stretch=1, shift=0, interpolate=0)

Shifts and stretches bin positions.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_bin_shift = supriya.ugens.PV_BinShift.new(
...     pv_chain=pv_chain, interpolate=0, shift=0, stretch=1,
... )
>>> pv_bin_shift
PV_BinShift.kr()

---

Attributes Summary

interpolate	Gets interpolate of PV_BinShift.
new	Constructs a PV_BinShift unit generator graph.
pv_chain	Gets pv_chain of PV_BinShift.
shift	Gets shift of PV_BinShift.
stretch	Gets stretch of PV_BinShift.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, stretch=1, shift=0, interpolate=0)

Constructs a PV_BinShift unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

interpolate

Gets interpolate of PV_BinShift.

Returns input.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_BinShift.

Returns input.

shift

Gets shift of PV_BinShift.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

stretch

Gets stretch of PV_BinShift.

Returns input.

class supriya.ugens.pv.PV_BinWipe(pv_chain_a=None, pv_chain_b=None, wipe=0)

Copies low bins from one input and the high bins of the other.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT.new(source=supriya.ugens.LFSaw.ar(),)
>>> pv_bin_wipe = supriya.ugens.PV_BinWipe.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b, wipe=0,
... )
>>> pv_bin_wipe
PV_BinWipe.kr()

---

Attributes Summary

new	Constructs a PV_BinWipe unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_BinWipe.
pv_chain_b	Gets pv_chain_b of PV_BinWipe.
wipe	Gets wipe of PV_BinWipe.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None, wipe=0)

Constructs a PV_BinWipe unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_BinWipe.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_BinWipe.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

wipe

Gets wipe of PV_BinWipe.

Returns input.

class supriya.ugens.pv.PV_BrickWall(pv_chain=None, wipe=0)

Zeros bins.

• If wipe == 0 then there is no effect.

• If wipe > 0 then it acts like a high pass filter, clearing bins from the bottom up.

• If wipe < 0 then it acts like a low pass filter, clearing bins from the top down.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_brick_wall = supriya.ugens.PV_BrickWall.new(pv_chain=pv_chain, wipe=0,)
>>> pv_brick_wall
PV_BrickWall.kr()

---

Attributes Summary

new	Constructs a PV_BrickWall unit generator graph.
pv_chain	Gets pv_chain of PV_BrickWall.
wipe	Gets wipe of PV_BrickWall.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, wipe=0)

Constructs a PV_BrickWall unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_BrickWall.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

wipe

Gets wipe of PV_BrickWall.

Returns input.

class supriya.ugens.pv.PV_ChainUGen(**kwargs)

Abstract base class for all phase-vocoder-chain unit generators.

---

Attributes Summary

fft_size

Gets FFT size as UGen input.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_ConformalMap(pv_chain=None, areal=0, aimag=0)

Complex plane attack.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_conformal_map = supriya.ugens.PV_ConformalMap.new(
...     aimag=0, areal=0, pv_chain=pv_chain,
... )
>>> pv_conformal_map
PV_ConformalMap.kr()

---

Attributes Summary

aimag	Gets aimag of PV_ConformalMap.
areal	Gets areal of PV_ConformalMap.
new	Constructs a PV_ConformalMap unit generator graph.
pv_chain	Gets pv_chain of PV_ConformalMap.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, areal=0, aimag=0)

Constructs a PV_ConformalMap unit generator graph.

Returns unit generator graph.

---

Read-only properties

aimag

Gets aimag of PV_ConformalMap.

Returns input.

areal

Gets areal of PV_ConformalMap.

Returns input.

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_ConformalMap.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Conj(pv_chain=None)

Complex conjugate.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_conj = supriya.ugens.PV_Conj.new(pv_chain=pv_chain,)
>>> pv_conj
PV_Conj.kr()

---

Attributes Summary

new	Constructs a PV_Conj unit generator graph.
pv_chain	Gets pv_chain of PV_Conj.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None)

Constructs a PV_Conj unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_Conj.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Copy(pv_chain_a=None, pv_chain_b=None)

Copies an FFT buffer.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_copy = supriya.ugens.PV_Copy.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,
... )
>>> pv_copy
PV_Copy.kr()

---

Attributes Summary

new	Constructs a PV_Copy unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Copy.
pv_chain_b	Gets pv_chain_b of PV_Copy.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Copy unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Copy.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Copy.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_CopyPhase(pv_chain_a=None, pv_chain_b=None)

Copies magnitudes and phases.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_copy_phase = supriya.ugens.PV_CopyPhase.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,
... )
>>> pv_copy_phase
PV_CopyPhase.kr()

---

Attributes Summary

new	Constructs a PV_CopyPhase unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_CopyPhase.
pv_chain_b	Gets pv_chain_b of PV_CopyPhase.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_CopyPhase unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_CopyPhase.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_CopyPhase.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Diffuser(pv_chain=None, trigger=0)

Shifts phases randomly.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_diffuser = supriya.ugens.PV_Diffuser.new(pv_chain=pv_chain, trigger=0,)
>>> pv_diffuser
PV_Diffuser.kr()

---

Attributes Summary

new	Constructs a PV_Diffuser unit generator graph.
pv_chain	Gets pv_chain of PV_Diffuser.
trigger	Gets trigger of PV_Diffuser.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, trigger=0)

Constructs a PV_Diffuser unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_Diffuser.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

trigger

Gets trigger of PV_Diffuser.

Returns input.

class supriya.ugens.pv.PV_Div(pv_chain_a=None, pv_chain_b=None)

Complex division.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_div = supriya.ugens.PV_Div.new(pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,)
>>> pv_div
PV_Div.kr()

---

Attributes Summary

new	Constructs a PV_Div unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Div.
pv_chain_b	Gets pv_chain_b of PV_Div.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Div unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Div.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Div.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_HainsworthFoote(pv_chain=None, proph=0, propf=0, threshold=1, waittime=0.04)

A FFT onset detector.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_hainsworth_foote = supriya.ugens.PV_HainsworthFoote.new(
...     pv_chain=pv_chain, propf=0, proph=0, threshold=1, waittime=0.04,
... )
>>> pv_hainsworth_foote
PV_HainsworthFoote.kr()

---

Attributes Summary

new	Constructs a PV_HainsworthFoote unit generator graph.
propf	Gets propf of PV_HainsworthFoote.
proph	Gets proph of PV_HainsworthFoote.
pv_chain	Gets pv_chain of PV_HainsworthFoote.
threshold	Gets threshold of PV_HainsworthFoote.
waittime	Gets waittime of PV_HainsworthFoote.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, proph=0, propf=0, threshold=1, waittime=0.04)

Constructs a PV_HainsworthFoote unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

propf

Gets propf of PV_HainsworthFoote.

Returns input.

proph

Gets proph of PV_HainsworthFoote.

Returns input.

pv_chain

Gets pv_chain of PV_HainsworthFoote.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

threshold

Gets threshold of PV_HainsworthFoote.

Returns input.

waittime

Gets waittime of PV_HainsworthFoote.

Returns input.

class supriya.ugens.pv.PV_JensenAndersen(pv_chain=None, propsc=0.25, prophfe=0.25, prophfc=0.25, propsf=0.25, threshold=1, waittime=0.04)

A FFT feature detector for onset detection.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_jensen_andersen = supriya.ugens.PV_JensenAndersen.new(
...     pv_chain=pv_chain,
...     prophfc=0.25,
...     prophfe=0.25,
...     propsc=0.25,
...     propsf=0.25,
...     threshold=1,
...     waittime=0.04,
... )
>>> pv_jensen_andersen
PV_JensenAndersen.kr()

---

Attributes Summary

new	Constructs a PV_JensenAndersen unit generator graph.
prophfc	Gets prophfc of PV_JensenAndersen.
prophfe	Gets prophfe of PV_JensenAndersen.
propsc	Gets propsc of PV_JensenAndersen.
propsf	Gets propsf of PV_JensenAndersen.
pv_chain	Gets pv_chain of PV_JensenAndersen.
threshold	Gets threshold of PV_JensenAndersen.
waittime	Gets waittime of PV_JensenAndersen.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, propsc=0.25, prophfe=0.25, prophfc=0.25, propsf=0.25, threshold=1, waittime=0.04)

Constructs a PV_JensenAndersen unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

prophfc

Gets prophfc of PV_JensenAndersen.

Returns input.

prophfe

Gets prophfe of PV_JensenAndersen.

Returns input.

propsc

Gets propsc of PV_JensenAndersen.

Returns input.

propsf

Gets propsf of PV_JensenAndersen.

Returns input.

pv_chain

Gets pv_chain of PV_JensenAndersen.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

threshold

Gets threshold of PV_JensenAndersen.

Returns input.

waittime

Gets waittime of PV_JensenAndersen.

Returns input.

class supriya.ugens.pv.PV_LocalMax(pv_chain=None, threshold=0)

Passes bins which are local maxima.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_local_max = supriya.ugens.PV_LocalMax.new(pv_chain=pv_chain, threshold=0,)
>>> pv_local_max
PV_LocalMax.kr()

---

Attributes Summary

new	Constructs a PV_LocalMax unit generator graph.
pv_chain	Gets pv_chain of PV_LocalMax.
threshold	Gets threshold of PV_LocalMax.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, threshold=0)

Constructs a PV_LocalMax unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_LocalMax.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

threshold

Gets threshold of PV_LocalMax.

Returns input.

class supriya.ugens.pv.PV_MagAbove(pv_chain=None, threshold=0)

Passes magnitudes above threshold.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_above = supriya.ugens.PV_MagAbove.new(pv_chain=pv_chain, threshold=0,)
>>> pv_mag_above
PV_MagAbove.kr()

---

Attributes Summary

new	Constructs a PV_MagAbove unit generator graph.
pv_chain	Gets pv_chain of PV_MagAbove.
threshold	Gets threshold of PV_MagAbove.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, threshold=0)

Constructs a PV_MagAbove unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagAbove.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

threshold

Gets threshold of PV_MagAbove.

Returns input.

class supriya.ugens.pv.PV_MagBelow(pv_chain=None, threshold=0)

Passes magnitudes below threshold.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_below = supriya.ugens.PV_MagBelow.new(pv_chain=pv_chain, threshold=0,)
>>> pv_mag_below
PV_MagBelow.kr()

---

Attributes Summary

new	Constructs a PV_MagBelow unit generator graph.
pv_chain	Gets pv_chain of PV_MagBelow.
threshold	Gets threshold of PV_MagBelow.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

overridden classmethod new(pv_chain=None, threshold=0)

Constructs a PV_MagBelow unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

overridden pv_chain

Gets pv_chain of PV_MagBelow.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

overridden threshold

Gets threshold of PV_MagBelow.

Returns input.

class supriya.ugens.pv.PV_MagClip(pv_chain=None, threshold=0)

Clips magnitudes.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_clip = supriya.ugens.PV_MagClip.new(pv_chain=pv_chain, threshold=0,)
>>> pv_mag_clip
PV_MagClip.kr()

---

Attributes Summary

new	Constructs a PV_MagClip unit generator graph.
pv_chain	Gets pv_chain of PV_MagClip.
threshold	Gets threshold of PV_MagClip.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

overridden classmethod new(pv_chain=None, threshold=0)

Constructs a PV_MagClip unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

overridden pv_chain

Gets pv_chain of PV_MagClip.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

overridden threshold

Gets threshold of PV_MagClip.

Returns input.

class supriya.ugens.pv.PV_MagDiv(pv_chain_a=None, pv_chain_b=None, zeroed=0.0001)

Divides magnitudes.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_mag_div = supriya.ugens.PV_MagDiv.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b, zeroed=0.0001,
... )
>>> pv_mag_div
PV_MagDiv.kr()

---

Attributes Summary

new	Constructs a PV_MagDiv unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_MagDiv.
pv_chain_b	Gets pv_chain_b of PV_MagDiv.
zeroed	Gets zeroed of PV_MagDiv.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None, zeroed=0.0001)

Constructs a PV_MagDiv unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_MagDiv.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_MagDiv.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

zeroed

Gets zeroed of PV_MagDiv.

Returns input.

class supriya.ugens.pv.PV_MagFreeze(pv_chain=None, freeze=0)

Freezes magnitudes.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_freeze = supriya.ugens.PV_MagFreeze.new(pv_chain=pv_chain, freeze=0,)
>>> pv_mag_freeze
PV_MagFreeze.kr()

---

Attributes Summary

freeze	Gets freeze of PV_MagFreeze.
new	Constructs a PV_MagFreeze unit generator graph.
pv_chain	Gets pv_chain of PV_MagFreeze.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, freeze=0)

Constructs a PV_MagFreeze unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

freeze

Gets freeze of PV_MagFreeze.

Returns input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagFreeze.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_MagMul(pv_chain_a=None, pv_chain_b=None)

Multiplies FFT magnitudes.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_mag_mul = supriya.ugens.PV_MagMul.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,
... )
>>> pv_mag_mul
PV_MagMul.kr()

---

Attributes Summary

new	Constructs a PV_MagMul unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_MagMul.
pv_chain_b	Gets pv_chain_b of PV_MagMul.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_MagMul unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_MagMul.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_MagMul.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_MagNoise(pv_chain=None)

Multiplies magnitudes by noise.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_noise = supriya.ugens.PV_MagNoise.new(pv_chain=pv_chain,)
>>> pv_mag_noise
PV_MagNoise.kr()

---

Attributes Summary

new	Constructs a PV_MagNoise unit generator graph.
pv_chain	Gets pv_chain of PV_MagNoise.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None)

Constructs a PV_MagNoise unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagNoise.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_MagShift(pv_chain=None, stretch=1, shift=0)

Shifts and stretches magnitude bin position.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_shift = supriya.ugens.PV_MagShift.new(
...     pv_chain=pv_chain, shift=0, stretch=1,
... )
>>> pv_mag_shift
PV_MagShift.kr()

---

Attributes Summary

new	Constructs a PV_MagShift unit generator graph.
pv_chain	Gets pv_chain of PV_MagShift.
shift	Gets shift of PV_MagShift.
stretch	Gets stretch of PV_MagShift.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, stretch=1, shift=0)

Constructs a PV_MagShift unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagShift.

Returns input.

shift

Gets shift of PV_MagShift.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

stretch

Gets stretch of PV_MagShift.

Returns input.

class supriya.ugens.pv.PV_MagSmear(pv_chain=None, bins=0)

Averages magnitudes across bins.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_smear = supriya.ugens.PV_MagSmear.new(bins=0, pv_chain=pv_chain,)
>>> pv_mag_smear
PV_MagSmear.kr()

---

Attributes Summary

bins	Gets bins of PV_MagSmear.
new	Constructs a PV_MagSmear unit generator graph.
pv_chain	Gets pv_chain of PV_MagSmear.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, bins=0)

Constructs a PV_MagSmear unit generator graph.

Returns unit generator graph.

---

Read-only properties

bins

Gets bins of PV_MagSmear.

Returns input.

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagSmear.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_MagSquared(pv_chain=None)

Squares magnitudes.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_mag_squared = supriya.ugens.PV_MagSquared.new(pv_chain=pv_chain,)
>>> pv_mag_squared
PV_MagSquared.kr()

---

Attributes Summary

new	Constructs a PV_MagSquared unit generator graph.
pv_chain	Gets pv_chain of PV_MagSquared.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None)

Constructs a PV_MagSquared unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_MagSquared.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Max(pv_chain_a=None, pv_chain_b=None)

Maximum magnitude.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_max = supriya.ugens.PV_Max.new(pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,)
>>> pv_max
PV_Max.kr()

---

Attributes Summary

new	Constructs a PV_Max unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Max.
pv_chain_b	Gets pv_chain_b of PV_Max.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Max unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Max.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Max.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Min(pv_chain_a=None, pv_chain_b=None)

Minimum magnitude.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_min = supriya.ugens.PV_Min.new(pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,)
>>> pv_min
PV_Min.kr()

---

Attributes Summary

new	Constructs a PV_Min unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Min.
pv_chain_b	Gets pv_chain_b of PV_Min.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Min unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Min.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Min.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_Mul(pv_chain_a=None, pv_chain_b=None)

Complex multiplication.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_mul = supriya.ugens.PV_Mul.new(pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b,)
>>> pv_mul
PV_Mul.kr()

---

Attributes Summary

new	Constructs a PV_Mul unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_Mul.
pv_chain_b	Gets pv_chain_b of PV_Mul.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None)

Constructs a PV_Mul unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_Mul.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_Mul.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_PhaseShift(pv_chain=None, shift=None, integrate=0)

Shifts phase.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> shift = supriya.ugens.LFNoise2.kr(1).scale(-1, 1, -180, 180)
>>> pv_phase_shift = supriya.ugens.PV_PhaseShift.new(
...     pv_chain=pv_chain, integrate=0, shift=shift,
... )
>>> pv_phase_shift
PV_PhaseShift.kr()

---

Attributes Summary

integrate	Gets integrate of PV_PhaseShift.
new	Constructs a PV_PhaseShift unit generator graph.
pv_chain	Gets pv_chain of PV_PhaseShift.
shift	Gets shift of PV_PhaseShift.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, shift=None, integrate=0)

Constructs a PV_PhaseShift unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

integrate

Gets integrate of PV_PhaseShift.

Returns input.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_PhaseShift.

Returns input.

shift

Gets shift of PV_PhaseShift.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_PhaseShift270(pv_chain=None)

Shifts phase by 270 degrees.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_phase_shift_270 = supriya.ugens.PV_PhaseShift270.new(pv_chain=pv_chain,)
>>> pv_phase_shift_270
PV_PhaseShift270.kr()

---

Attributes Summary

new	Constructs a PV_PhaseShift270 unit generator graph.
pv_chain	Gets pv_chain of PV_PhaseShift270.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None)

Constructs a PV_PhaseShift270 unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_PhaseShift270.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_PhaseShift90(pv_chain=None)

Shifts phase by 90 degrees.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_phase_shift_90 = supriya.ugens.PV_PhaseShift90.new(pv_chain=pv_chain,)
>>> pv_phase_shift_90
PV_PhaseShift90.kr()

---

Attributes Summary

new	Constructs a PV_PhaseShift90 unit generator graph.
pv_chain	Gets pv_chain of PV_PhaseShift90.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None)

Constructs a PV_PhaseShift90 unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_PhaseShift90.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

class supriya.ugens.pv.PV_RandComb(pv_chain=None, wipe=0, trigger=0)

Passes random bins.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_rand_comb = supriya.ugens.PV_RandComb.new(
...     pv_chain=pv_chain, trigger=0, wipe=0,
... )
>>> pv_rand_comb
PV_RandComb.kr()

---

Attributes Summary

new	Constructs a PV_RandComb unit generator graph.
pv_chain	Gets pv_chain of PV_RandComb.
trigger	Gets trigger of PV_RandComb.
wipe	Gets wipe of PV_RandComb.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, wipe=0, trigger=0)

Constructs a PV_RandComb unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain

Gets pv_chain of PV_RandComb.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

trigger

Gets trigger of PV_RandComb.

Returns input.

wipe

Gets wipe of PV_RandComb.

Returns input.

class supriya.ugens.pv.PV_RandWipe(pv_chain_a=None, pv_chain_b=None, wipe=0, trigger=0)

Crossfades in random bin order.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_rand_wipe = supriya.ugens.PV_RandWipe.new(
...     pv_chain_a=pv_chain_a, pv_chain_b=pv_chain_b, trigger=0, wipe=0,
... )
>>> pv_rand_wipe
PV_RandWipe.kr()

---

Attributes Summary

new	Constructs a PV_RandWipe unit generator graph.
pv_chain_a	Gets pv_chain_a of PV_RandWipe.
pv_chain_b	Gets pv_chain_b of PV_RandWipe.
trigger	Gets trigger of PV_RandWipe.
wipe	Gets wipe of PV_RandWipe.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None, wipe=0, trigger=0)

Constructs a PV_RandWipe unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

pv_chain_a

Gets pv_chain_a of PV_RandWipe.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_RandWipe.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

trigger

Gets trigger of PV_RandWipe.

Returns input.

wipe

Gets wipe of PV_RandWipe.

Returns input.

class supriya.ugens.pv.PV_RectComb(pv_chain=None, num_teeth=0, phase=0, width=0.5)

Makes gaps in the spectrum.

>>> pv_chain = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_rect_comb = supriya.ugens.PV_RectComb.new(
...     pv_chain=pv_chain, num_teeth=0, phase=0, width=0.5,
... )
>>> pv_rect_comb
PV_RectComb.kr()

---

Attributes Summary

new	Constructs a PV_RectComb unit generator graph.
num_teeth	Gets num_teeth of PV_RectComb.
phase	Gets phase of PV_RectComb.
pv_chain	Gets pv_chain of PV_RectComb.
width	Gets width of PV_RectComb.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain=None, num_teeth=0, phase=0, width=0.5)

Constructs a PV_RectComb unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

num_teeth

Gets num_teeth of PV_RectComb.

Returns input.

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

phase

Gets phase of PV_RectComb.

Returns input.

pv_chain

Gets pv_chain of PV_RectComb.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

width

Gets width of PV_RectComb.

Returns input.

class supriya.ugens.pv.PV_RectComb2(pv_chain_a=None, pv_chain_b=None, num_teeth=0, phase=0, width=0.5)

Makes gaps in the spectrum.

>>> pv_chain_a = supriya.ugens.FFT(source=supriya.ugens.WhiteNoise.ar(),)
>>> pv_chain_b = supriya.ugens.FFT(source=supriya.ugens.LFSaw.ar(),)
>>> pv_rect_comb_2 = supriya.ugens.PV_RectComb2.new(
...     pv_chain_a=pv_chain_a,
...     pv_chain_b=pv_chain_b,
...     num_teeth=0,
...     phase=0,
...     width=0.5,
... )
>>> pv_rect_comb_2
PV_RectComb2.kr()

---

Attributes Summary

new	Constructs a PV_RectComb2 unit generator graph.
num_teeth	Gets num_teeth of PV_RectComb2.
phase	Gets phase of PV_RectComb2.
pv_chain_a	Gets pv_chain_a of PV_RectComb2.
pv_chain_b	Gets pv_chain_b of PV_RectComb2.
width	Gets width of PV_RectComb2.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod new(pv_chain_a=None, pv_chain_b=None, num_teeth=0, phase=0, width=0.5)

Constructs a PV_RectComb2 unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(PV_ChainUGen).fft_size

Gets FFT size as UGen input.

Returns ugen input.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

num_teeth

Gets num_teeth of PV_RectComb2.

Returns input.

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

phase

Gets phase of PV_RectComb2.

Returns input.

pv_chain_a

Gets pv_chain_a of PV_RectComb2.

Returns input.

pv_chain_b

Gets pv_chain_b of PV_RectComb2.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.

width

Gets width of PV_RectComb2.

Returns input.

class supriya.ugens.pv.RunningSum(calculation_rate=None, source=None, sample_count=40)

Tracks running sum over n frames.

>>> source = supriya.ugens.In.ar(bus=0)
>>> running_sum = supriya.ugens.RunningSum.ar(sample_count=40, source=source,)
>>> running_sum
RunningSum.ar()

---

Attributes Summary

ar	Constructs a audio-rate RunningSum unit generator graph.
kr	Constructs a control-rate RunningSum unit generator graph.
sample_count	Gets sample_count of RunningSum.
source	Gets source of RunningSum.

---

Special methods

(UGenMethodMixin).__abs__()

Gets absolute value of ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = abs(ugen_graph)
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f21696d155a2686700992f0e9a04a79c
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = abs(ugen_graph)
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1d45df2f3d33d1b0641d2c464498f6c4
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(ABSOLUTE_VALUE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__add__(expr)

Adds expr to ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6bf4339326d015532b7604cd7af9ad3b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph + expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f4a3c1ed35cc5f6fe66b70a3bc520b10
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph + expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f79088cc154ef2b65c72a0f8de8336ce
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(ADDITION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__div__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__ge__(expr)

Tests if ugen graph if greater than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9db96233abf1f610d027ff285691482d
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph >= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6d43342b3787aa11a46cea54412407e1
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph >= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: b06931195bab8e6f6ca2e3a857e71a95
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__getitem__(i)

Gets output proxy at index i.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen[0]
SinOsc.ar()[0]

Returns output proxy.

(UGenMethodMixin).__graph__()

Gets Graphviz representation of ugen graph.

Returns GraphvizGraph instance.

(UGenMethodMixin).__gt__(expr)

Tests if ugen graph if greater than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 01bebf935112af62ffdd282a99581904
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph > expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 55642179864ad927e9d5cf6358367677
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(GREATER_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph > expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5177e03443ad31ee2664aae2201fb979
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(GREATER_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__le__(expr)

Tests if ugen graph if less than or equal to expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fefc06cbbc3babb35046306c6d41e3c5
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph <= expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 53f29d793fd676fbca1d541e938b66ca
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph <= expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3cf0414af96d130edf2e1b839f73036c
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN_OR_EQUAL).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGen).__len__()

Gets number of ugen outputs.

Returns integer.

(UGenMethodMixin).__lt__(expr)

Tests if ugen graph if less than expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 844f34c0ffb28ecc24bd5cf0bae20b43
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph < expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 14c1494fe4e153e690a8ef0a42e5834f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(LESS_THAN).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph < expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e87d41791847aa80d8a3e56318e506e4
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(LESS_THAN).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mod__(expr)

Gets modulo of ugen graph and expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4a06e157474f8d1ae213916f3cf585a
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph % expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 90badce1cf8fc1752b5eb99b29122a14
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MODULO).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph % expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bfa60877061daf112516cc3ec8c7ff69
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MODULO).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__mul__(expr)

Multiplies ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ea2b5e5cec4e2d5a1bef0a8dda522bd3
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph * expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9d353c198344b6be3635244197bc2a4b
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph * expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1735acd4add428d8ab317d00236b0fe7
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__neg__()

Negates ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = -ugen_graph
>>> result
UnaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a987a13f0593e4e4e070acffb11d5c3e
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(NEGATIVE).ar:
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=(440, 442, 443),)
>>> result = -ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e5dfc1d4ecb11ed8170aaf11469a6443
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/0:
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/1:
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   UnaryOpUGen(NEGATIVE).ar/2:
            source: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__pow__(expr)

Raises ugen graph to the power of expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 3498b370c0575fb2c2ed45143ba2da4f
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph ** expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04e78034682f9ffd6628fbfd09a28c13
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph ** expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 50b8e3b154bc85c98d76ced493a32731
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(POWER).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__radd__(expr)

Adds ugen graph to expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr + ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: bb0592fad58b0bfa1a403c7ff6a400f3
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr + ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0ad0a3d4b7ddf8bb56807813efc62202
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(ADDITION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rdiv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGen).__repr__()

Gets interpreter representation of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> repr(ugen)
'SinOsc.ar()'

>>> ugen = supriya.ugens.WhiteNoise.kr()
>>> repr(ugen)
'WhiteNoise.kr()'

>>> ugen = supriya.ugens.Rand.ir()
>>> repr(ugen)
'Rand.ir()'

Returns string.

(UGenMethodMixin).__rmod__(expr)

Gets modulo of expr and ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr % ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr % ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rmul__(expr)

Multiplies expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr * ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f60bbe0480298a7ae8b54de5a4c0260f
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr * ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0295153106bff55a2bf6db3b7184d301
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rpow__(expr)

Raises expr to the power of ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr ** ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c450618c9e0fe5213629275da4e5e354
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr ** ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a614dc68313ee7ca2677e63fd499de0d
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(POWER).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rsub__(expr)

Subtracts ugen graph from expr.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr - ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 74e331121aa41f4d49a6d38a38ca4a9a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr - ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 1ca2e8f3f541b9365413a0dbf9028e95
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__rtruediv__(expr)

Divides expr by ugen graph.

Example 1:

>>> expr = 1.5
>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> result = expr / ugen_graph
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d79490206a430281b186b188d617f679
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: 1.5
            right: SinOsc.ar[0]

Example 2:

>>> expr = [220, 330]
>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = expr / ugen_graph
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: d71b3081490f800d5136c87f5fef46d1
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: 220.0
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: 330.0
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: 220.0
            right: SinOsc.ar/2[0]

Returns ugen graph.

(UGenMethodMixin).__str__()

Gets string representation of ugen graph.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> print(str(ugen_graph))
synthdef:
    name: c9b0ed62d4e0666b74166ff5ec09abe4
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[1, 2, 3])
>>> print(str(ugen_graph))
synthdef:
    name: 4015dac116b25c54b4a6f02bcb5859cb
    ugens:
    -   SinOsc.ar/0:
            frequency: 1.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 2.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 3.0
            phase: 0.0

Returns string.

(UGenMethodMixin).__sub__(expr)

Subtracts expr from ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: cd62fff8ff3ad7758d0f7ad82f39c7ce
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph - expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 9a8355f84507908cadf3cc63187ddab4
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph - expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 48ca704043ed00a2b6a55fd4b6b72cf1
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(SUBTRACTION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

(UGenMethodMixin).__truediv__(expr)

Divides ugen graph by expr.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar()
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6da024a346859242c441fe03326d2adc
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.WhiteNoise.kr()
>>> expr = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph / expr
>>> result
UGenArray({3})

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: be20d589dfccb721f56da8b002d86763
    ugens:
    -   WhiteNoise.kr: null
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/0:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/1:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   BinaryOpUGen(FLOAT_DIVISION).ar/2:
            left: WhiteNoise.kr[0]
            right: SinOsc.ar/2[0]

Example 3:

>>> ugen_graph = supriya.ugens.Dust.ar(density=11.5,)
>>> expr = 4
>>> result = ugen_graph / expr
>>> result
BinaryOpUGen.ar()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 672765c596fcaa083186b2f2b996ba1d
    ugens:
    -   Dust.ar:
            density: 11.5
    -   BinaryOpUGen(FLOAT_DIVISION).ar:
            left: Dust.ar[0]
            right: 4.0

Returns ugen graph.

---

Methods

(UGenMethodMixin).absolute_difference(expr)

Calculates absolute difference between ugen graph and expr.

>>> ugen_graph = supriya.ugens.SinOsc.ar()
>>> expr = supriya.ugens.WhiteNoise.kr()
>>> result = ugen_graph.absolute_difference(expr)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a6b274b5f30e1dfa86ac1d00ef1c169b
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(ABSOLUTE_DIFFERENCE).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).amplitude_to_db()

Converts ugen graph from amplitude to decibels.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.amplitude_to_db()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 73daa5fd8db0d28c03c3872c845fd3ed
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(AMPLITUDE_TO_DB).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).as_int()

(UGenMethodMixin).ceiling()

Calculates the ceiling of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.ceiling()
>>> print(operation)
synthdef:
    name: c7b1855219f3364f731bdd2e4599b1d1
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CEILING).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).clip(minimum, maximum)

Clips ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e710843b0e0fbc5e6185afc6cdf90149
    ugens:
    -   WhiteNoise.ar: null
    -   Clip.ar:
            maximum: 0.25
            minimum: -0.25
            source: WhiteNoise.ar[0]

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.clip(-0.25, 0.25)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 000e997ea0d7e8637c9f9040547baa50
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Clip.ar/0:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Clip.ar/1:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Clip.ar/2:
            maximum: 0.25
            minimum: -0.25
            source: SinOsc.ar/2[0]

(UGenMethodMixin).cubed()

Calculates the cube of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.cubed()
>>> print(operation)
synthdef:
    name: ad344666e7f3f60edac95b1ea40c412d
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(CUBED).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).db_to_amplitude()

Converts ugen graph from decibels to amplitude.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.db_to_amplitude()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: fe82aae42b01b2b43d427cafd77c1c22
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).distort()

Distorts ugen graph non-linearly.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.distort()
>>> print(operation)
synthdef:
    name: bb632e15f448820d93b3880ad943617b
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(DISTORT).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential()

Calculates the natural exponential function of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.exponential()
>>> print(operation)
synthdef:
    name: f3b8b1036b3cceddf116c3f6a3c5a9a0
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(EXPONENTIAL).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).exponential_range(minimum=0.01, maximum=1.0)

(UGenMethodMixin).floor()

Calculates the floor of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.floor()
>>> print(operation)
synthdef:
    name: 407228cfdb74bdd79b51c425fb8a7f77
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FLOOR).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).fractional_part()

Calculates the fraction part of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.fractional_part()
>>> print(operation)
synthdef:
    name: c663d5ee6c7c5347c043727c628af658
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(FRACTIONAL_PART).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).hanning_window()

Calculates Hanning-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.hanning_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 18cb43db42ae3499f2c233e83df877fd
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HANNING_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_midi()

Converts ugen graph from Hertz to midi note number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_midi()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 227a6ae85bc89b3af939cff32f54e36a
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).hz_to_octave()

Converts ugen graph from Hertz to octave number.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.hz_to_octave()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e4fd4ca786d453fc5dfb955c63b6fbf6
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(HZ_TO_OCTAVE).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).is_equal_to(expr)

Calculates equality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_equal_to(right)
>>> print(operation)
synthdef:
    name: 8287d890708ce26adff4968d63d494a0
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).is_not_equal_to(expr)

Calculates inequality between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.is_not_equal_to(right)
>>> print(operation)
synthdef:
    name: b9f77aa86bc08a3b023d8f664afef05d
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(NOT_EQUAL).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).lag(lag_time=0.5)

Lags ugen graph.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6c3e2cc1a3d54ecfaa49d567a84eae77
    ugens:
    -   WhiteNoise.ar: null
    -   Lag.ar:
            lag_time: 0.5
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.lag(0.5)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 67098a4ddab35f6e1333a80a226bf559
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   Lag.ar/0:
            lag_time: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   Lag.ar/1:
            lag_time: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Lag.ar/2:
            lag_time: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).log()

Calculates the natural logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log()
>>> print(operation)
synthdef:
    name: 4da44dab9d935efd1cf098b4d7cec420
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log10()

Calculates the base-10 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log10()
>>> print(operation)
synthdef:
    name: 122d9333b8ac76164782d00707d3386a
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG10).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).log2()

Calculates the base-2 logarithm of ugen graph.

>>> source = supriya.ugens.DC.ar(source=0.5)
>>> operation = source.log2()
>>> print(operation)
synthdef:
    name: f956f79a387ffbeb409326046397b4dd
    ugens:
    -   DC.ar:
            source: 0.5
    -   UnaryOpUGen(LOG2).ar:
            source: DC.ar[0]

Returns ugen graph.

(UGenMethodMixin).maximum(expr)

Calculates maximum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.maximum(right)
>>> print(operation)
synthdef:
    name: dcdca07fb0439c8b4321f42803d18c32
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MAXIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).midi_to_hz()

Converts ugen graph from midi note number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.midi_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 5faaa2c74715175625d774b20952f263
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(MIDI_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).minimum(expr)

Calculates minimum between ugen graph and expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.minimum(right)
>>> print(operation)
synthdef:
    name: f80c0a7b300911e9eff0e8760f5fab18
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(MINIMUM).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).octave_to_hz()

Converts ugen graph from octave number to Hertz.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.octave_to_hz()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 04c00b0f32088eb5e4cef0549aed6d96
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(OCTAVE_TO_HZ).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).power(expr)

Raises ugen graph to the power of expr.

>>> left = supriya.ugens.SinOsc.ar()
>>> right = supriya.ugens.WhiteNoise.kr()
>>> operation = left.power(right)
>>> print(operation)
synthdef:
    name: 06d6d3fe992bff8fce9ef55db6863c2a
    ugens:
    -   SinOsc.ar:
            frequency: 440.0
            phase: 0.0
    -   WhiteNoise.kr: null
    -   BinaryOpUGen(POWER).ar:
            left: SinOsc.ar[0]
            right: WhiteNoise.kr[0]

Returns ugen graph.

(UGenMethodMixin).range(minimum=0.0, maximum=1.0)

(UGenMethodMixin).ratio_to_semitones()

Converts ugen graph from frequency ratio to semitone distance.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.ratio_to_semitones()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e23630ade4fab35fc821c190b7f33db
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(RATIO_TO_SEMITONES).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).reciprocal()

Calculates reciprocal of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.reciprocal()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 2e1c714d0def9d5c310197861d725559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECIPROCAL).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).rectangle_window()

Calculates rectangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.rectangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 0d296187bbdb205f3a283f301a5fad61
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(RECTANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).s_curve()

Calculates S-curve of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.s_curve()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 21bcaf49922e2c4124d4cadba85c00ac
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(S_CURVE).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).scale(input_minimum, input_maximum, output_minimum, output_maximum, exponential=False)

Scales ugen graph from input_minimum and input_maximum to output_minimum and output_maximum.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e2295e64ed7b9c949ec22ccdc82520e3
    ugens:
    -   WhiteNoise.ar: null
    -   MulAdd.ar:
            addend: 0.625
            multiplier: 0.125
            source: WhiteNoise.ar[0]

>>> ugen_graph = supriya.ugens.SinOsc.ar(frequency=[440, 442, 443],)
>>> result = ugen_graph.scale(-1, 1, 0.5, 0.75, exponential=True)

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 88dca305143542bd40a82d8a6a337306
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   LinExp.ar/0:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/0[0]
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   LinExp.ar/1:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/1[0]
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   LinExp.ar/2:
            input_maximum: 1.0
            input_minimum: -1.0
            output_maximum: 0.75
            output_minimum: 0.5
            source: SinOsc.ar/2[0]

(UGenMethodMixin).semitones_to_ratio()

Converts ugen graph from semitone distance to frequency ratio.

>>> ugen_graph = supriya.ugens.WhiteNoise.ar()
>>> result = ugen_graph.semitones_to_ratio()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: f77ac2c24b06f8e620817f14285c2877
    ugens:
    -   WhiteNoise.ar: null
    -   UnaryOpUGen(SEMITONES_TO_RATIO).ar:
            source: WhiteNoise.ar[0]

Returns ugen graph.

(UGenMethodMixin).sign()

Calculates sign of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sign()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 6f62abd8306dbf1aae66c09dd98203b5
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(SIGN).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).softclip()

Distorts ugen graph non-linearly.

(UGenMethodMixin).square_root()

Calculates square root of ugen graph.

(UGenMethodMixin).squared()

Calculates square of ugen graph.

(UGenMethodMixin).sum()

Sums ugen graph.

Example 1:

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: 350f2065d4edc69244399dcaff5a1ceb
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0

Example 2:

>>> ugen_graph = supriya.ugens.SinOsc.ar([440, 442, 443])
>>> result = ugen_graph.sum()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a1d26283f87b8b445db982ff0e831fb7
    ugens:
    -   SinOsc.ar/0:
            frequency: 440.0
            phase: 0.0
    -   SinOsc.ar/1:
            frequency: 442.0
            phase: 0.0
    -   SinOsc.ar/2:
            frequency: 443.0
            phase: 0.0
    -   Sum3.ar:
            input_one: SinOsc.ar/0[0]
            input_three: SinOsc.ar/2[0]
            input_two: SinOsc.ar/1[0]

Returns ugen graph.

(UGenMethodMixin).tanh()

Calculates hyperbolic tangent of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.tanh()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: e74aa9abf6e389d8ca39d2c9828d81be
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TANH).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).transpose(semitones)

Transposes ugen graph by semitones.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.transpose([0, 3, 7])

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: c481c3d42e3cfcee0267250247dab51f
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(HZ_TO_MIDI).ar:
            source: LFNoise2.ar[0]
    -   UnaryOpUGen(MIDI_TO_HZ).ar/0:
            source: UnaryOpUGen(HZ_TO_MIDI).ar[0]
    -   BinaryOpUGen(ADDITION).ar/0:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 3.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/1:
            source: BinaryOpUGen(ADDITION).ar/0[0]
    -   BinaryOpUGen(ADDITION).ar/1:
            left: UnaryOpUGen(HZ_TO_MIDI).ar[0]
            right: 7.0
    -   UnaryOpUGen(MIDI_TO_HZ).ar/2:
            source: BinaryOpUGen(ADDITION).ar/1[0]

Returns ugen graph.

(UGenMethodMixin).triangle_window()

Calculates triangle-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.triangle_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: ebb1820b9d08a639565b5090b53681db
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(TRIANGLE_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

(UGenMethodMixin).welch_window()

Calculates Welch-window of ugen graph.

>>> ugen_graph = supriya.ugens.LFNoise2.ar()
>>> result = ugen_graph.welch_window()

>>> supriya.graph(result)  

>>> print(result)
synthdef:
    name: a0a01a549a5606d9eb0026bf458e4559
    ugens:
    -   LFNoise2.ar:
            frequency: 500.0
    -   UnaryOpUGen(WELCH_WINDOW).ar:
            source: LFNoise2.ar[0]

Returns ugen graph.

---

Class & static methods

classmethod ar(source=None, sample_count=40)

Constructs a audio-rate RunningSum unit generator graph.

Returns unit generator graph.

classmethod kr(source=None, sample_count=40)

Constructs a control-rate RunningSum unit generator graph.

Returns unit generator graph.

---

Read-only properties

(UGen).calculation_rate

Gets calculation-rate of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.calculation_rate
CalculationRate.AUDIO

Returns calculation-rate.

(UGen).has_done_flag

(UGen).inputs

Gets inputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> for input_ in ugen.inputs:
...     input_
... 
WhiteNoise.kr()[0]
0.5

Returns tuple.

(UGen).is_input_ugen

(UGen).is_output_ugen

(UGen).outputs

Gets outputs of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.outputs
(CalculationRate.AUDIO,)

Returns tuple.

sample_count

Gets sample_count of RunningSum.

Returns input.

(UGen).signal_range

Gets signal range of ugen.

>>> ugen = supriya.ugens.SinOsc.ar()
>>> ugen.signal_range
SignalRange.BIPOLAR

A bipolar signal range indicates that the ugen generates signals above and below zero.

A unipolar signal range indicates that the ugen only generates signals of 0 or greater.

Returns signal range.

source

Gets source of RunningSum.

Returns input.

(UGen).special_index

Gets special index of ugen.

>>> ugen = supriya.ugens.SinOsc.ar(
...     frequency=supriya.ugens.WhiteNoise.kr(), phase=0.5,
... )
>>> ugen.special_index
0

The special index of most ugens will be 0. SuperColliders’s synth definition file format uses the special index to store the operator id for binary and unary operator ugens, and the parameter index of controls.

Returns integer.